home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / 1stsysop.zip / 1STSYSOP.DOC < prev    next >
Text File  |  1992-07-01  |  15KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.          Qmail Door setup utilities for 1stReader
  8.          ----------------------------------------
  9.  
  10.  
  11.          Welcome sysop to 1stReader.  1stReader is a new offline mail
  12.          reader from Sparkware that is designed "from the ground up"
  13.          for novice bulletin board users.  "Power users" haven't been
  14.          forgotten either when we designed 1stReader too...they will
  15.          find alot to like in 1st.
  16.  
  17.          When we started designing Qmail Door back in 1987 we've
  18.          always had a system like 1stReader on the drawing boards.
  19.          Today, using Qmail Door 4.00 (release date 06-01-92 or later)
  20.          and these utilities, you can setup your Qmail Door system so
  21.          the novice user can get the most out of using offline mail.
  22.  
  23.          It's important to keep the novice users calling your system.
  24.          If you run your board on a subscription basis, you know what
  25.          we mean.  A novice user might sign up for one year's
  26.          subscription and become frustrated trying to use your system.
  27.          When renewal time comes around, that user might not renew and
  28.          that is money out of your pocket.  It is in YOUR best
  29.          interest to keep them using your system and finding useful
  30.          information.
  31.  
  32.          1stReader is a QWK-format offline mail reader with internal
  33.          telecommuncations with the Zmodem file transfer protocol,
  34.          internal ZIP and UNZIP routines, internal editor, LIST, file
  35.          and program manager.  It includes EVERYTHING you need to
  36.          handle offline mail.
  37.  
  38.          1stReader is not a replacement for our Qmail DeLuxe² mail
  39.          reader.  That product will continue to be developed as a
  40.          "power user's" product.  Look for 1stReader to be released on
  41.          or after July 2nd, 1992.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.          Installing The Qmail Door utilities
  74.          -----------------------------------
  75.  
  76.          Two archives have been provided to you for use with your
  77.          Qmail Door.  These archives are:
  78.  
  79.               ADD-INS.ZIP         Contains 'add-in' utilities used
  80.                                   by Qmail Door to make configuration
  81.                                   easier for 1st-time callers.  This
  82.                                   file also includes the latest TEXT
  83.                                   files needed to bring your Qmail
  84.                                   system up-to-date.
  85.  
  86.               CONFIG.ZIP          This is an updated version of the
  87.                                   CONFIG utility for Qmail Door.  Our
  88.                                   new 1stReader can take advantage of
  89.                                   this utility so callers can modify
  90.                                   their Qmail Door setups offline.
  91.  
  92.          Uncompress both of these utilities into seperate
  93.          subdirectories.  Then, follow the instructions provided to
  94.          install them into your Qmail Door system.
  95.  
  96.  
  97.  
  98.  
  99.          1stReader Setup
  100.          ---------------
  101.  
  102.          1stReader is designed so the novice user can be productive
  103.          with The Qmail Door on their first call to the Qmail Door.
  104.          In order to do this, you will need to create a few files that
  105.          will be used by Qmail Door and 1stReader to provide this easy
  106.          interface.
  107.  
  108.          Let's start at the very beginning.  That's when a 1stReader
  109.          user decides they wish to call your system and they create a
  110.          new entry for your system in the dialing directory.
  111.  
  112.          For a novice, here comes the first hurdle.  They need to know
  113.          the telephone numbers to your bulletin board system, the baud
  114.          rates you support and the command required to open The Qmail
  115.          Door, just for starters.  This is where you can help the
  116.          novice user out.
  117.  
  118.          1stReader supports what we call .BBS ("dot BBS") files.
  119.          These files are archives created by ZIP and they contain a
  120.          file named 1ST.DIR.  They can contain other files (discussed
  121.          later) but the file MUST contain 1ST.DIR.  The name of the
  122.          .BBS file must match your Qmail Door "QWK-ID".  For example,
  123.          a .BBS file for "Salt Air" would be named SALTAIR.BBS since
  124.          the Salt Air Qmail Door creates SALTAIR.QWK mail packets.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          When the novice user enters the name of your QWK-ID into
  140.          1stReader the program looks for this .BBS file.  If the file
  141.          is found its contents are unpacked and 1ST.DIR is located.
  142.          Then, 1stReader will load the entries in 1ST.DIR onto the
  143.          novice user's screen.
  144.  
  145.          All they need to do is to enter the name they use to log into
  146.          your bulletin board system and their password.  They *may*
  147.          need to change the telephone numbers you have provided if
  148.          they are local to you and you have provided telephone numbers
  149.          with area codes.
  150.  
  151.          After the novice user saves the dialing entry to your
  152.          bulletin board system they are ready to call your BBS,
  153.          automatically login into The Qmail Door and download messages
  154.          on their first call.
  155.  
  156.          That, in a nutshell, is the concept behind the .BBS file and
  157.          1ST.DIR.  You can create a 1ST.DIR file for your own system
  158.          using the program 1ST-EDIT.EXE that we have provided in this
  159.          archive.
  160.  
  161.  
  162.  
  163.          Other files you can include in a .BBS file
  164.          ------------------------------------------
  165.  
  166.          Besides 1ST.DIR, there are a number of other files you can
  167.          include in your .BBS file.
  168.  
  169.          The second most import file is named "READ.ME".  If 1stReader
  170.          finds this file inside the .BBS file then the contents of the
  171.          file are immediately displayed to the user.  You can use this
  172.          file to describe your system, its features and rules to the
  173.          user.  Feel free to include any information you see fit.
  174.  
  175.          Another file type you can include in the .BBS file is the
  176.          $$CALL file.  You can include $$CALL.ASC (for monochrome
  177.          users) and $$CALL.ANS (for color users) when they add your
  178.          system to the dialing directory, this file is displayed to
  179.          the user (which one depends on if they are configured for
  180.          color or not inside 1stReader).  Think of this file as
  181.          providing you a graphic "introduction" to your system.  The
  182.          $$CALL file is also displayed to the user every time they
  183.          call your system using 1stReader's internal telecom module.
  184.  
  185.          Script files can be included in your .BBS file if the default
  186.          scripts provided with 1stReader just don't seem to work with
  187.          your system.  Usually, this is due to you having changed the
  188.          default PCBoard prompts.  However, we've tested the 1stReader
  189.          scripts for some time now and have yet to find a system that
  190.          will not work with them.  Don't take this as a challenge, I'm
  191.          sure somehow you can probably change your PCBoard system so
  192.          they won't work, but for now, we haven't seen it.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.          There are three script files provided with 1stReader to call
  207.          your system.  These files are:
  208.  
  209.               $$CALL.SCR          Calls your system and places the
  210.                                   user in a terminal mode that lets
  211.                                   them use your system interactively.
  212.  
  213.               $$MAIL.SCR          Calls your system, opens The Qmail
  214.                                   Door, uploads any waiting replies
  215.                                   and downloads any new messages.
  216.  
  217.               $$REPLY.SCR         Calls your system, opens The Qmail
  218.                                   Door and only uploads any waiting
  219.                                   replies.
  220.  
  221.          If you wish, you can provide custom versions of these files
  222.          if you require them.  The default versions of these can be
  223.          found inside the 1stReader system files.
  224.  
  225.          If you keep in mind the concept we used to design 1stReader,
  226.          then creating the .BBS file is easy.  We wanted to provide a
  227.          way for the novice user to get "on board" your system with
  228.          minimal fuss and also give 1stReader users a "flavor" of your
  229.          system.
  230.  
  231.          The natural question to ask is "How does the novice user
  232.          receive a .BBS file?".  The best answers are that they will
  233.          download them from your own system using a telecommunications
  234.          program like ProComm, Telix or other systems.  1stReader will
  235.          look for .BBS files in the main system subdirectory, the file
  236.          download subdirectory, or even inside a .QWK file that might
  237.          be on the user's own system.
  238.  
  239.          If you decide to take advantage of our sysop dealer plan
  240.          (outlined later) we can copy your .BBS file onto the
  241.          distribution diskette shipped to the caller.  1stReader will
  242.          then automatically insert information about your system into
  243.          the dialing directory when the program is installed.
  244.  
  245.          We have set aside conference #7 on our customer support
  246.          system as a "clearing house" for .BBS files and BBS ads.  If
  247.          you like, please to upload your .BBS file to our conference
  248.          #7 so others can take advantage of them.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.          Configuring Qmail Door
  272.          ----------------------
  273.  
  274.          Now that you have created a .BBS file for your system you
  275.          need to make sure you have properly configured Qmail Door for
  276.          novice users.
  277.  
  278.          Qmail Door lets you setup certain conferences as "default
  279.          conferences" for new users.  This means that when a user
  280.          opens the Qmail Door for the first time these conferences are
  281.          automatically selected for them.
  282.  
  283.          Obviously, your MAIN BOARD conference should be one of these
  284.          conferences.  We also recommend that you create a "novice
  285.          users" conference and select it as a default conference.
  286.          We've found that novice users sometimes do not ask questions
  287.          in public for fear of showing their lack of knowledge.  A
  288.          "novice users" conference tends to help counter this feeling.
  289.  
  290.          To select these default conferences you need to execute the
  291.          program "QMSETUP.EXE".  You will find this program located
  292.          inside your QM4 subdirectory on your system.  When you are at
  293.          the QmSetup main menu select "G  Conference Flags".  You will
  294.          then see a prompt asking you to enter the node number you
  295.          wish to edit.  Simply press ENTER without a node number now.
  296.          A list of conferences will next appear on your screen.  Use
  297.          the arrow keys to select which conferences you wish to make
  298.          "default" conferences.  Place an "X" in column #1 of each of
  299.          these conferences.
  300.  
  301.          When you are finished press the [ESC] key to return back to
  302.          the menu and save your changes.  That's it!
  303.  
  304.  
  305.          The 1ST subdirectory
  306.          --------------------
  307.  
  308.          The Qmail Door lets you place files inside a subdirectory
  309.          named "QM4\1ST-TIME".  When a caller downloads a mail packet
  310.          inside Qmail Door for the first time, these files are
  311.          automatically copied into the caller's .QWK packet.
  312.  
  313.          1stReader also supports a file named 1ST-TIME.ZIP.  If
  314.          1ST-TIME.ZIP is found inside a .QWK mail packet that has been
  315.          unpacked then the contents of the archive are unpacked into
  316.          the 1stReader 'BBS' subdirectory.
  317.  
  318.          Unlike 'database' readers, 1stReader keeps any bulletins, new
  319.          file lists and other related information on file for the user
  320.          to access at any time.  You can, if you wish, provide the
  321.          user with any special files in 1ST-TIME.ZIP.  If 1ST-TIME.ZIP
  322.          is located in the QM4\1ST-TIME subdirectory then the file
  323.          will be sent to the caller on their first mail packet
  324.          download.  The file will not be sent to the user again.
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.          That's about it
  338.          ---------------
  339.  
  340.          You now have completed all of the steps needed to provide
  341.          your 1stReader users with a seamless and easy-to-use
  342.          interface for your bulletin board system.  While these steps
  343.          might seem a bit difficult, they really help out 1stReader
  344.          and novice users.  Of course, even "power users" who call
  345.          your system will benefit too.
  346.  
  347.          We strongly recommend that if you are not using a copy of
  348.          QMAIL4.EXE that was released on (or after) 06-01-92 that you
  349.          call our customer support system at (615) 230-8822 and
  350.          download a copy of QM4.ZIP from conference #4.  If the lines
  351.          are busy we also maintain a full set of Qmail Door files on
  352.          our sister system - Sound Advice at (816) 436-4516.
  353.  
  354.  
  355.  
  356.  
  357.          Thanks for your support!
  358.          ------------------------
  359.  
  360.          Since you own a copy of Qmail Door we have designed 1stReader
  361.          so your QMAIL4.KEY file will 'register' the reader to you.
  362.          All you need to do is copy your QMAIL4.KEY file into the
  363.          1stReader system subdirectory.  Feel free to use 1stReader or
  364.          our Qmail DeLuxe² offline mail reader...whichever system you
  365.          prefer.  HOWEVER, we do not allow you to keep one offline
  366.          mail system and give the other unused system to a friend.
  367.          BOTH copies are registered to you.
  368.  
  369.          We also can provide you with copies of 1stReader that have
  370.          been initialized for your bulletin board system.  You can
  371.          include them in your subscription kits for new users and they
  372.          can begin using your system immediately.  Call our customer
  373.          support system at (615) 230-8822 for more details.
  374.  
  375.          We hope you enjoy using Qmail Door and 1stReader!
  376.  
  377.  
  378.  
  379.                                             --- Sparky
  380.                                                 July 1st, 1992
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.          Customer Support
  404.          ----------------
  405.  
  406.          Customer support for 1stReader is provided through our
  407.          PCBoard system.  You can reach the system 24 hours a day by
  408.          calling (615) 230-8822.  Join conference #1 for 1stReader
  409.          support (after July 2nd, 1992).
  410.  
  411.          We also monitor the Qmail Support conferences on ILink,
  412.          Intelec, NorthAmeriNet and RIME (a bit more now that
  413.          1stReader is released!).
  414.  
  415.          Finally, you can reach our offices at (615) 230-MAIL between
  416.          the hours of 10:00 am and 5:00 pm (Central Time), weekdays.
  417.          If we are not available an answering machine will take your
  418.          message and we will call you back, collect.
  419.  
  420.  
  421.  
  422.  
  423.          Sparkware
  424.          Post Office Box 386
  425.          Hendersonville, Tennessee   37077-0386
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.